home *** CD-ROM | disk | FTP | other *** search
/ Aminet 39 / Aminet 39 (2000)(Schatztruhe)[!][Oct 2000].iso / Aminet / mus / play / DelfSF.readme < prev    next >
Text File  |  2000-09-02  |  5KB  |  125 lines
  1. Short:    Sndfile player for Delfina DSP
  2. Author:   Smack/Infect! (Michael Henke)
  3. Type:     mus/play
  4. Replaces: mus/misc/DelfSF.lha
  5.  
  6. $VER: DelfSF 0.2 (Wed 19-Jul-2000)
  7.  
  8.  
  9.  #features
  10.    -reads audio files using sndfile.library
  11.     (supports various file formats and raw PCM files)
  12.  
  13.    -direct Delfina playback for best performance + quality
  14.  
  15.    -free software (full source code included, of course)
  16.  
  17.  
  18.  #requirements
  19.    -CPU 68020+
  20.    -AmigaOS V37+
  21.    -Delfina DSP board
  22.    -sndfile.library v1.21
  23.      you can find it in the latest port of LAME (3.85beta)
  24.      http://www.honeypot.net/audio/archives/LAMEbeta.lzx
  25.  
  26.    -developed on: A1200 (68030+882 @ 40MHz, 16MB Fast, Delfina1200 DSP)
  27.  
  28.  
  29.  #changes since previous release
  30.    -several little code cleanups and fixes
  31.    -fixed Aminet path (has been mus/misc by mistake)
  32.  
  33.  
  34.  #how to use it
  35.    DelfSF is a shell-only program. These options can be used:
  36.  
  37.    FILES            specify one or more filenames.
  38.                     if omitted a reqtools file requester appears.
  39.  
  40.    NOPLAY   / -n    don't play but just output some information.
  41.                     this works also without a Delfina board.
  42.  
  43.    NOTIMER  / -nt   don't output the position timer during playback.
  44.                     you should specify this option if you use DelfSF to play
  45.                     some background music while you're using other programs.
  46.                     (pulldown-menus, drag'n'drop etc. will block the timer
  47.                     output thus also delaying the file reader)
  48.  
  49.    VOLUME  / -vol <number>   (default: 100)
  50.                     set the playback volume (in per cent, range 0...200).
  51.                     warning: if the volume is boosted (101...200) there might
  52.                     be distortions due to output clipping.
  53.  
  54.    RATE     / -r  <number>   (default: 44100)
  55.    -raw-            set the playback rate in Hz (raw files only).
  56.  
  57.    BITS     / -b  <number>   (default: 16)
  58.    -raw-            set the number of bits per sample (raw files only).
  59.  
  60.    CHANNELS / -c  <number>   (default: 2)
  61.    -raw-            set the number of channels (raw files only).
  62.  
  63.    BYTESWAP / -bs   (default: false)
  64.    -raw-            set the sample format to 'little endian' (raw files only).
  65.                     try this if your 16bit (CDDA) files sound like static.
  66.  
  67.    note: raw files will only be played if at least one of the raw file options
  68.    (RATE, BITS, CHANNELS, BYTESWAP) is specified, in order to avoid accidental
  69.    playback of non-audio files which could be very noisy.
  70.  
  71.    During playback these keys can be used:
  72.  
  73.    Ctrl-F   fast forward
  74.    Ctrl-E   pause/continue
  75.    Ctrl-C   stop current file, start next file
  76.    Ctrl-D   quit program
  77.  
  78.  
  79.  #technical stuff
  80.    -The source code of DelfSF is split into two parts: the main part contains
  81.     all the generic stuff (file requester, sndfile.library calls, buffering)
  82.     while the Delfina-specific code is situated in a separate part.
  83.     This should make it fairly easy to write a player for other output devices
  84.     (e.g. Amiga native, sound boards, AHI), recycling the main part of DelfSF
  85.     and only replacing its Delfina part. Feel free to contact me if you have
  86.     any comments, suggestions or need some help concerning the code.
  87.  
  88.  
  89.  #author
  90.    mailto: smack@smack.de
  91.  
  92.    DelfSF - sndfile player for Delfina DSP
  93.    Copyright (C) 2000  Michael Henke
  94.  
  95.    This program is free software; you can redistribute it and/or modify
  96.    it under the terms of the GNU General Public License as published by
  97.    the Free Software Foundation; either version 2 of the License, or
  98.    (at your option) any later version.
  99.  
  100.    This program is distributed in the hope that it will be useful,
  101.    but WITHOUT ANY WARRANTY; without even the implied warranty of
  102.    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  103.    GNU General Public License for more details.
  104.  
  105.    You should have received a copy of the GNU General Public License
  106.    along with this program; if not, write to the Free Software
  107.    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  108.  
  109.  
  110. ============================= Archive contents =============================
  111.  
  112. Original  Packed Ratio    Date     Time    Name
  113. -------- ------- ----- --------- --------  -------------
  114.    18113    7000 61.3% 19-Jul-00 20:56:34 +COPYING
  115.    18400   11409 37.9% 19-Jul-00 20:56:34 +DelfSF
  116.     4045    1931 52.2% 19-Jul-00 20:56:34 +DelfSF.readme
  117.      182     141 22.5% 19-Jul-00 20:56:34 +CHANGES
  118.     4657    1783 61.7% 19-Jul-00 20:56:34 +delf.c
  119.     3313    1493 54.9% 19-Jul-00 20:56:34 +delf_PCM.a56
  120.    11385    3465 69.5% 19-Jul-00 20:56:34 +main.c
  121.      112      87 22.3% 19-Jul-00 20:56:34 +SCOPTIONS
  122.      202     106 47.5% 19-Jul-00 20:56:34 +smakefile
  123. -------- ------- ----- --------- --------
  124.    60409   27415 54.6% 21-Jul-100 19:44:10   9 files
  125.